VGETCHRS                              Introduced: v3.12

  .  Summary

  vgetchrs(int <x>, int <y>, str <buf>, int <pos>, int <num>);

  .  Description

  The vgetchrs function is used to read multiple characters starting
  from a spot on the screen into a specified variable. Vgetchrs saves
  only the characters (a sequence of bytes). <x>,<y> is the spot on
  the screen to start reading characters. <buf> is the string variable
  to put characters into, starting at an offset of <pos> in the variable.
  Note that this function does not put a 0 (NULL, or end of string charac-
  ter) at the end of the sequence of characters it grabs. If the
  characters returned by vgetchrs are to be manipulated as a string a
  0 must be added at the end with the setchr function.

  .  Return Value

  None.

  .  Example

  // copy 20 characters starting from 10,10 on the screen to 20,20
  // Don't keep color attributes
  str buffer[20];
  vgetchrs(10, 10, buffer, 0, 20);
  vputchrs(20, 20, buffer, 0, 20);